Validation de l'identité de l'annonceur

Pour offrir un écosystème publicitaire fiable et sûr aux utilisateurs, et pour respecter nouvelles réglementations, Google demande désormais aux annonceurs de respecter au moins programmes de validation.

Si vous devez suivre un programme de validation, une date limite peut être définie pour la procédure de validation. Si le délai est dépassé sans validation votre compte risque d'être mis en veille.

Vous pouvez également vous soumettre à une procédure de validation proactive, sans que vous ayez à le faire. IdentityVerificationService propose des méthodes pour effectuer les opérations suivantes:

• Récupérer l'état du processus de validation d'un compte client y compris les échéances
• Lancer une procédure de validation

Récupérer l'état de validation

Pour récupérer l'état de la procédure de validation de l'identité de l'annonceur pour compte client, appelez la méthode GetIdentityVerification:

Java

This example is not yet available in Java; you can take a look at the other languages.
    

C#

private static IdentityVerification GetIdentityVerification(
        GoogleAdsClient client, long customerId)
{
    IdentityVerificationServiceClient identityVerificationService =
        client.GetService(Services.V17.IdentityVerificationService);

    try {
        GetIdentityVerificationResponse response =
            identityVerificationService.GetIdentityVerification(
                new GetIdentityVerificationRequest()
                {
                    CustomerId = customerId.ToString()
                }
            );

            if (response.IdentityVerification.Count == 0)
            {
                return null;
            }

            IdentityVerification identityVerification = response.IdentityVerification[0];
            string deadline =
                identityVerification.IdentityVerificationRequirement.VerificationCompletionDeadlineTime;
             IdentityVerificationProgress identityVerificationProgress =
                identityVerification.VerificationProgress;
            Console.WriteLine($"Account {customerId} has a verification completion " +
                $"deadline of {deadline} and status " +
                $"{identityVerificationProgress.ProgramStatus} for advertiser identity " +
                "verification.");

            return identityVerification;
    } catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }


}
VerifyAdvertiserIdentity.cs
      

PHP

This example is not yet available in PHP; you can take a look at the other languages.
    

Python

This example is not yet available in Python; you can take a look at the other languages.
    

Ruby

def get_identity_verification(client, customer_id)
  response = client.service.identity_verification.get_identity_verification(
    customer_id: customer_id
  )

  return nil if response.nil? || response.identity_verification.empty?

  identity_verification = response.identity_verification.first
  deadline = identity_verification.
    identity_verification_requirement.
    verification_completion_deadline_time
  progress = identity_verification.verification_progress
  puts "Account #{customer_id} has a verification completion deadline " \
    "of #{deadline} and status #{progress.program_status} for advertiser " \
    "identity verification."

  identity_verification
end
verify_advertiser_identity.rb
      

Perl

sub get_identity_verification {
  my ($api_client, $customer_id) = @_;

  my $response = $api_client->IdentityVerificationService()->get({
    customerId => $customer_id
  });

  if (!defined $response->{identityVerification}) {
    printf "Account %s does not require advertiser identity verification.",
      $customer_id;
    return;
  }

  my $identity_verification = $response->{identityVerification}[0];
  my $deadline = $identity_verification->{identityVerificationRequirement}
    {verificationCompletionDeadlineTime};
  my $identity_verification_progress =
    $identity_verification->{verificationProgress};

  printf "Account %s has a verification completion deadline of %s and status " .
    "%s for advertiser identity verification.", $customer_id, $deadline,
    $identity_verification_progress->{programStatus};
  return $identity_verification;
}
verify_advertiser_identity.pl
      

Si le compte client utilise l'identité d'annonceur obligatoire programme de vérification, le service renvoie une réponse non vide contenant un liste d'objets IdentityVerification. Une Une réponse vide indique que le compte client n'est pas tenu de passer la validation de l'identité de l'annonceur.

Depuis la version 16, l'API Google Ads n'accepte que le ADVERTISER_IDENTITY_VERIFICATION programme, ce qui serait le seul élément de la liste.

Un objet IdentityVerification contient les propriétés suivantes:

• Un élément IdentityVerificationRequirement décrivant les délais à respecter commencer et terminer la procédure de validation

• Un élément IdentityVerificationProgress décrivant l'état actuel de la procédure de validation: elle peut également inclure l'URL d'action de l'utilisateur. pour terminer la procédure de validation.

Lancer la validation

Si un compte client utilise l'identité d'annonceur obligatoire programme de validation : GetIdentityVerification a renvoyé un avec une date limite pour terminer le processus de validation, vous pouvez une session de vérification en appelant StartIdentityVerification:

Java

This example is not yet available in Java; you can take a look at the other languages.
    

C#

private static void StartIdentityVerification(GoogleAdsClient client, long customerId)
{
    IdentityVerificationServiceClient identityVerificationService =
        client.GetService(Services.V17.IdentityVerificationService);

    StartIdentityVerificationRequest request = new StartIdentityVerificationRequest()
    {
        CustomerId = customerId.ToString(),
        VerificationProgram = IdentityVerificationProgram.AdvertiserIdentityVerification
    };

    try {
        identityVerificationService.StartIdentityVerification(request);
    } catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }
}
VerifyAdvertiserIdentity.cs
      

PHP

This example is not yet available in PHP; you can take a look at the other languages.
    

Python

This example is not yet available in Python; you can take a look at the other languages.
    

Ruby

def start_identity_verification(client, customer_id)
  client.service.identity_verification.start_identity_verification(
    customer_id: customer_id,
    verification_program: :ADVERTISER_IDENTITY_VERIFICATION,
  )
end
verify_advertiser_identity.rb
      

Perl

sub start_identity_verification {
  my ($api_client, $customer_id) = @_;

  my $request =
    Google::Ads::GoogleAds::V17::Services::IdentityVerificationService::StartIdentityVerificationRequest
    ->new({
      customerId          => $customer_id,
      verificationProgram => ADVERTISER_IDENTITY_VERIFICATION
    });

  $api_client->AdvertiserIdentityVerificationService()
    ->start_identity_verification($request);
}
verify_advertiser_identity.pl
      

Cette opération n'aboutira que si aucune autre session de validation n'est en cours. Une fois que vous avez démarré une session de validation, les appels suivants GetIdentityVerification renvoie l'URL d'action que l'utilisateur doit effectuer. le processus de vérification et l'heure d'expiration de l'URL d'action.

Une fois le délai d'expiration écoulé, vous pouvez appeler StartIdentityVerification. pour démarrer une nouvelle session de vérification.